home *** CD-ROM | disk | FTP | other *** search
/ Ultimate Add-On's (Tournament Edition) / Cybercore Publishing - Ultimate Add-on's Tournament Edition.iso / tools / doom / dms / dms.doc < prev    next >
Text File  |  1994-08-11  |  4KB  |  106 lines
  1.  
  2. ================================================================
  3. Title                   : Doom Mouse Spinner (DMS) v0.12 beta
  4. Filename                : DMS.COM
  5. Authors                 : Tom Klok and Dave 'Zoid' Kirsch
  6. Email Address           : a344@mindlink.bc.ca
  7.  
  8. Description             : Ever had the problem of a monster or
  9.                           deathmatch opponent sneaking up behind
  10.                           you?  Ever needed to turn around *now*?
  11.                           With DMS, you can rotate your player
  12.                           180 degrees with a click of the mouse!
  13.  
  14. Release note            : This is a *BETA* release.  DMS has been
  15.                           tested with Logitech 3-button and
  16.                           Microsoft 2-button mice.  It should work
  17.                           with others without problems.  I don't
  18.                           know what it would do with a CyberMan.
  19.  
  20. Construction            : TASM 3.1, TLINK 5.1
  21.  
  22. ================================================================
  23.  
  24.  
  25. What it is
  26. ~~~~~~~~~~
  27.      DMS is a tiny TSR (384 bytes resident) that intercepts Doom's
  28. calls to the mouse driver.  By clicking the mouse buttons that you
  29. define, it will instantly turn you 180 degrees -- facing the opposite
  30. direction.
  31.  
  32.      It supports mouse "chords".  For example, if you have a 2-button
  33. mouse you can set it up to spin you only when you press the left and
  34. right mouse button at the same time.  3-button mice permit even more
  35. combinations.  I prefer the Middle+Right button chord on my Logitech.
  36.  
  37.  
  38. Does it work for Deathmatch?
  39. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  40.      You're not very nice, are you?  :)
  41.  
  42.  
  43. How it works
  44. ~~~~~~~~~~~~
  45.      Doom uses two standard Mouse API services:
  46.  
  47.           function AX=0003h             - mouse button status
  48.           function AX=000Bh             - mouse delta mickey counts
  49.  
  50.      A 'mickey' is the smallest unit of mouse movement... sort of like
  51. a pixel on the screen.  Every time Doom requests the new delta mickey
  52. counts, the mouse driver returns the number of mickeys (X and Y,
  53. positive and negative) the mouse has moved since the last request.
  54.  
  55.      DMS hooks interrupt 33h, the mouse driver interrupt, and watches
  56. for those two function requests.  Whenever Doom asks for the latest
  57. button status, DMS passes the request on to the mouse driver and then
  58. checks to see if the special button(s) have been pressed.  If they
  59. have, it masks them out (tells Doom they never happened) and adds 180
  60. degrees to the X-axis mickeys the next time Doom asks for them.
  61.  
  62.      DMS was written in assembly language for small size.  Source code
  63. is included.
  64.  
  65.  
  66. How to install it
  67. ~~~~~~~~~~~~~~~~~
  68.      Put DMS.COM in your Doom directory, or some other directory in your
  69. DOS path.  Simply type 'DMS' to load it.  Be sure you load it AFTER your
  70. mouse driver, not before, or it won't work.
  71.  
  72.      'dms -?' or 'dms -h' will display some simple usage help.  To
  73. configure your own button preferences, run DMS with a parameter
  74. indicating which buttons you want.  The default is the right mouse
  75. button.  For example, if you prefer the Left+Right buttons to spin
  76. you, enter 'dms -lr'.  Since I like Middle and Right, I use 'dms -mr'.
  77.  
  78.      You can change your button definitions by running DMS again.  It
  79. will detect that it is already loaded and just update the buttons.
  80.  
  81.      DMS may be loaded into conventional memory, or high memory (UMB's).
  82. There really isn't any point in loading it high, however, as Doom doesn't
  83. need much conventional memory and DMS only consumes 384 bytes resident.
  84.  
  85.  
  86. How to uninstall it
  87. ~~~~~~~~~~~~~~~~~~~
  88.      DMS doesn't include software to release itself.  Sorry.  Go
  89. download the MARK/RELEASE tools, or just reboot after you're done.
  90.  
  91.  
  92. Legal stuff
  93. ~~~~~~~~~~~
  94.      DMS is Copyright (c) 1994 Tom Klok and Dave Kirsch.  Permission
  95. is granted to distribute it via any media (Internet, BBS, CDROM, etc)
  96. as long as full attributions are maintained and the source code is
  97. included.  If you modify the source and build something new with it,
  98. please have the courtesy of leaving our names on it as well and
  99. mailing us a copy.  If you are a CDROM producer and include this
  100. package with your distribution, we expect a free copy of your disk as
  101. compensation.  Write to Tom Klok at a344@mindlink.bc.ca to notify
  102. us and get a shipping address.
  103.  
  104. -- tk 11Aug94Th
  105.  
  106.